Menu principale¶

Il menu principale è il punto di accesso a tutte le funzioni del ricevitore. Si raggiunge digitando +++ (3 caratteri + consecutivi) dopo aver connesso al ricevitore via Bluetooth (SPP / BLE) o WiFi (TCP).

Il contenuto varia leggermente in base alla modalità radio attiva e ai servizi correntemente attivi. Le sezioni seguenti mostrano entrambe le varianti.

Schermata in modalità SPP / BLE¶

In modalità Bluetooth (SPP Classic o BLE NUS) il menu si presenta così:

 MS2-AC1518EDCB22
==================
Version: 3.0.0
Online: SPP+SD
Uptime: 1h:23m:45s
Mode: ROVER
NCLI: Streaming (age 2.3s)
Battery: 87% (4.12V)
Satellites: 12
Heap: 145312 free / 98432 min
Quality: RTK FIXED (hAcc=0.15m)

[m] Mode (ROVER_BT)
[h] GNSS Settings (1Hz, 10 deg)
[w] Network (192.168.1.100)
[s] SD Card (REC 12.3MB)
[t] Radio (SPP)
[z] Restart / Factory reset
[x] Exit

Schermata in modalità WIFI¶

In modalità WIFI il menu include due righe aggiuntive (PVT-Srv e MQTT, se i servizi sono attivi) e la voce [u] OTA update:

 MS2-AC1518EDCB22
==================
Version: 3.0.0
Online: WiFi+PVT+MQTT
Uptime: 1h:23m:45s
Mode: ROVER
NCLI: Streaming (age 0.7s)
PVT-Srv: Online (port 2947, 1 clients)
MQTT: Online (broker.example.com:1883, root ms2/EDCB20)
Battery: 87% (4.12V)
Satellites: 30
Heap: 137320 free / 133732 min
Quality: RTK FIX (hAcc=0.01m)

[m] Mode (ROVER)
[h] GNSS Settings (1Hz, 10 deg)
[w] Network (192.168.1.50)
[s] SD Card (n/a)
[t] Radio (WIFI)
[u] OTA update
[z] Restart / Factory reset
[x] Exit

Header: spiegazione riga per riga¶

Riga 1 — Nome dispositivo: MS2-<MAC last 12 hex>

Identificativo univoco del ricevitore, derivato dal MAC address.

Riga 2 — separatore ==================

Solo decorativo.

Riga 3 — Version: 3.0.0

Versione corrente del firmware ricevitore.

Riga 4 — Online: <lista servizi>

Servizi di rete attualmente attivi, concatenati con +. Esempi:

Online: SPP — solo SPP
Online: BLE — solo BLE
Online: WiFi — WIFI mode senza altri servizi
Online: WiFi+PVT — WIFI + PVT TCP server
Online: WiFi+NCLI — WIFI + NTRIP Client streaming
Online: WiFi+NSER — WIFI + NTRIP Server (Base caster)
Online: WiFi+PVT+MQTT — WIFI + PVT + MQTT publisher
Online: SPP+WiFi+SD — SPP attivo + WiFi (opt-in) + logging SD

Riga 5 — Uptime: NhMmSs

Tempo trascorso dall’ultimo boot del ricevitore.

Riga 6 — Mode: <modalità>

Modalità operativa GNSS corrente. Valori:

ROVER — modulo GNSS in tmode=0 (rover standalone)
ROVER NTRIP — rover con NTRIP Client attivo
BASE SURVEY-IN — modulo in SVIN, attesa completamento
BASE FIXED — modulo in tmode=2 con coordinate fisse
BASE NTRIP CASTER — base che invia RTCM a un caster

Riga 7 — NCLI: <stato> (solo se NCLI attivo)

Stato NTRIP Client:

Streaming (age N.Ns) — corrections in arrivo, age = secondi dall’ultimo RTCM
Connecting... — handshake in corso
Idle — fermato
Error: ... — errore di connessione

Riga 8 — PVT-Srv: Online (port N, N clients) (solo WIFI mode, se attivo)

Stato PVT TCP server: porta in ascolto e numero client connessi.

Riga 9 — MQTT: Online (broker:port, root <root>) (solo WIFI mode, se connesso)

Stato MQTT publisher: broker connesso, topic root in uso.

Riga 10 — Battery: NN% (V.VVV)

Percentuale stimata + tensione misurata in volt.

Riga 11 — Satellites: N

Numero satelliti correntemente tracciati e usati nel fix.

Riga 12 — Heap: N free / N min

Memoria libera corrente / minima storica (low-water-mark). Vedi Stabilità e memoria per soglie critiche.

Riga 13 — Evt: OOM=N Wi=N NCli=N NSrv=N (solo se almeno uno > 0)

Contatori persistenti di eventi anomali tra reboot. Vedi Stabilità e memoria.

Riga 14 — Quality: <fix type> (hAcc=N.Nm)

Qualità del fix GNSS:

NO FIX — nessuna posizione valida
2D — fix bidimensionale
3D — fix tridimensionale standalone (~3-5 m)
DGNSS — fix differenziale (~0.5-1 m)
RTK FLOAT — RTK in float (~10-30 cm)
RTK FIXED — RTK fisso (~1-2 cm)
hAcc = horizontal accuracy stimata

Voci di menu¶

Tutte le modalità mostrano [m], [h], [w], [s], [t], [z], [x]. In modalità WIFI con WiFi connesso compare anche [u] OTA update.

Tasto	Voce	Descrizione
`[m]`	Mode	5 modalità RTK: Rover BT, Rover NTRIP, Base SVIN, Base Fixed, Base NTRIP Caster. Vedi NTRIP Client e Modalità Base.
`[h]`	GNSS Settings	Rate (1/2/5/10 Hz), Elevation cutoff, Dynamic model, Messages. Vedi GNSS Settings.
`[w]`	Network	WiFi, NTRIP, PVT, MQTT (solo WIFI). Vedi Menu via WiFi (TCP) e MQTT publisher.
`[s]`	SD Card	Start/stop logging, modalità auto, format. Vedi Registrazione su SD.
`[t]`	Radio (SRA)	Scegli modalità radio SPP/BLE/WIFI. Vedi Modalità radio (SRA).
`[u]`	OTA update	Solo WIFI mode + WiFi connesso. Aggiornamento firmware via HTTPS. Vedi Update FW ricevitore.
`[z]`	Restart / Factory reset	Restart GNSS, Restart ESP32, Factory Reset GNSS. Vedi Restart e Factory Reset.
`[x]`	Exit	Esci dal menu, torna allo stream NMEA.

Voci condizionali e nascoste¶

Alcune voci del menu sono visibili solo in determinate condizioni:

`[u] OTA update` — solo se bt_pref==2 (WIFI mode) AND WiFi STA connesso. In SPP/BLE non compare.
Riga `PVT-Srv: Online …` — solo se PVT TCP server è attivo (sempre in WIFI mode, opt-in in SPP/BLE).
Riga `MQTT: Online …` — solo se MQTT publisher è connesso al broker.
Riga `NCLI: Streaming …` — solo se NTRIP Client è in streaming attivo.
Riga `Evt: OOM=N …` — solo se almeno un contatore eventi è > 0.

Refresh del menu¶

Il menu si aggiorna automaticamente ogni ~5 secondi quando sei nel menu principale o nei sotto-menu in whitelist (non in input prompt). I dati live (battery, satellites, quality, age NTRIP, heap) sono sempre attuali al momento della visualizzazione.

Per forzare un refresh manuale immediato, premi Invio (riga vuota) nel menu principale.

Per i sotto-menu in input prompt (es. inserimento valore numerico per [a] Duration), il refresh non avviene per non disturbare l’inserimento.

Pagine correlate¶

Primo avvio del ricevitore — come accendere e accedere al menu la prima volta
Menu via WiFi (TCP) — accesso al menu via socat / telnet
Tutte le altre pagine della Guida all’uso documentano i singoli sotto-menu del [m], [h], [w], [s], [t], [u], [z].